Получение информации о бронировании

Запрос позволяет получить информацию о бронировании.

Синтаксис запроса

POST https://b2b-api.go.yandex.ru/integration/integration/v2/avia/bookings/info

Заголовки запроса

Authorization: Bearer <OAuth-токен>
Процесс получения токена описан в разделе Начало работы.

X-YaTaxi-Selected-Corp-Client-Id — ID клиента из Личного кабинета. Обязателен, если по токену доступно несколько клиентов.

Тело запроса

Данные передаются в формате JSON:

Поле	Описание	Формат	Обязательность
`id`	Идентификатор бронирования.	Строка	Да

В ответе могут содержаться следующие поля:

Поле	Описание	Формат	Обязательность
`id`	Идентификатор бронирования.	Строка	Да
`status`	Статус бронирования.	Статус бронирования	Да
`status_reason`	Причина статуса.	Строка	Нет
`travel`	Информация о поездке.	Информация о поездке	Да
`pnr_locator`	PNR локатор.	Строка	Нет
`booking_number`	Номер бронирования.	Строка	Нет
`booked_until`	Забронировано до.	Строка в формате даты и времени	Да
`refundable_before_departure`	Возвратный до вылета.	Булево	Нет
`customer_email`	Email заказчика.	Email	Нет
`customer_phone`	Телефон заказчика.	Номер телефона	Нет
`total_cost`	Общая стоимость.	Цена	Да
`forward_trip`	Прямой рейс.	Информация о бронировании поездки	Да
`backward_trip`	Обратный рейс. Структура аналогична `forward_trip`.	Информация о бронировании поездки	Нет
`users`	Список пассажиров.	Массив	Да
`extras`	Дополнительные услуги.	Массив	Нет
`refunds`	Возвраты.	Массив	Нет
3D-контракт.	Булево

Структура объекта travel:

Структура объекта forward_trip:

Поле	Описание	Формат	Обязательность
`departure_city`	Город отправления.	Строка	Да
`departure_airport`	Аэропорт отправления.	Строка	Да
`departure_time`	Время отправления.	Строка в формате даты и времени	Да
`arrival_city`	Город прибытия.	Строка	Да
`arrival_airport`	Аэропорт прибытия.	Строка	Да
`arrival_time`	Время прибытия.	Строка в формате даты и времени	Да
`total_duration`	Общая длительность в минутах.	Число	Да
`flights`	Список рейсов.	Массив строк	Да

Структура объекта flights:

Поле	Описание	Формат	Обязательность
`segment_order`	Номер рейса по счету, начиная с 1.	Число	Да
`airline`	Название авиакомпании.	Строка	Да
`airline_logo_svg`	URL логотипа авиакомпании.	Строка	Нет
`airline_code`	Код авиакомпании.	Строка	Да
`flight_number`	Номер рейса.	Строка	Да
`departure_city`	Город отправления.	Строка	Да
`departure_airport`	Аэропорт отправления.	Строка	Да
`departure_airport_code`	Код аэропорта отправления.	Строка	Да
`departure_time`	Время отправления.	Строка в формате даты и времени	Да
`arrival_city`	Город прибытия.	Строка	Да
`arrival_airport`	Аэропорт прибытия.	Строка	Да
`arrival_airport_code`	Код аэропорта прибытия.	Строка	Да
`arrival_time`	Время прибытия.	Строка в формате даты и времени	Да
`total_duration`	Продолжительность рейса в минутах.	Число	Да
`stop`	Информация об остановке.	Объект	Нет
`tech_stops`	Технические остановки.	Массив	Нет
`baggage_info`	Информация о багаже.	Массив	Нет
`service_class`	Класс обслуживания.	Класс обслуживания	Да

Структура объекта stop:

Поле	Описание	Формат	Обязательность
`duration`	Длительность остановки в минутах.	Число	Да
`has_airport_change`	Есть ли смена аэропорта.	Булево	Да
`is_night_stop`	Ночная остановка.	Булево	Да

Структура объекта users:

Поле	Описание	Формат	Обязательность
`user_id`	Идентификатор пользователя.	Строка	Да
`first_name`	Имя.	Строка	Да
`last_name`	Фамилия.	Строка	Да
`patronymic`	Отчество.	Строка	Нет
`citizenship`	Гражданство.	Строка	Да
`document_type`	Тип документа: `INTERNAL`, `FOREIGN`, `BIRTHDAY_NOTIFICATION`, `PASSPORTLOSSCERTIFICATE`, `MILITARYID`, `PASSPORT`, `DIPLOMATIC`, `FOREIGN_NATIONAL_PASSPORT`, `SEAMANSID`.	Строка	Да
`document_number`	Номер документа.	Строка	Да
`document_expire_date`	Дата истечения документа.	Строка в формате даты и времени	Да
`birth_date`	Дата рождения.	Строка в формате даты и времени	Да
`gender`	Пол: `MALE`, `FEMALE`.	Строка	Да
`total_cost`	Общая стоимость для пассажира.	Цена	Да

Структура объекта extras:

Поле	Описание	Формат	Обязательность
`user_id`	Идентификатор пользователя.	Строка	Да
`extra_type`	Тип услуги.	Тип Услуги	Да
`cost`	Стоимость.	Цена	Да
`description`	Описание	Строка	Нет
`segment_numbers`	Номера рейсов.	Массив чисел	Нет
`quantity`	Количество. Минимальное значение: 1.	Число	Нет

Структура объекта refunds:

Поле	Описание	Формат	Обязательность
`id`	Идентификатор возврата.	Строка	Да
`user_id`	Идентификатор пользователя.	Строка	Нет
`refund_status`	Статус возврата.	статус возврата	Да
`refund_cost`	Сумма возврата.	Цена	Да